XMLSocket.connect()

Доступность

Flash Player 5; во Flash Player 7 претерпел изменения.

Синтаксис

myXMLSocket.connect(host:String, port:Number) : Boolean

Параметры

host Строка; полное доменное имя или IP в виде aaa.bbb.ccc.ddd. Также вы можете передать значение null, чтобы присоединить к серверу в том же домене, что и SWF файл. Если SWF файл, осуществляющий соединение, запущен в браузере, host должен быть в том же домене, что и SWF файле; подробнее смотри в пункте Описание.

port Число; номер TCP порта сервера, через который будет установлено соединение. Порт должен иметь номер, равный или больший 1024.

Возвращает

Булеву величину.

Описание

Метод; устанавливает соединение с указанным веб-узлом, используя указанный TCP порт (должен быть 1024 или выше) и возвращает true или false, в зависимости от того, удачно ли установлено соединение. Если вы не знаете номер порта сервера, свяжитесь с вашим системным администратором.

Если передать null параметру host, соединение произойдет с узлом, в котором находится SWF файл. Например, если SWF файл находится в домене www.yoursite.com, передача значения null параметру host равносильна введению IP адреса домена www.yoursite.com.

В SWF файлах, проигрываемых во Flash Player до7 версии, host должен быть в том же наддомене, что и SWF файл, осуществляющий попытку соединения. Например, SWF файл по адресу www.someDomain.com может получать данные из SWF файлов в store.someDomain.com, потому что оба файла находятся в одном наддомене someDomain.com.

В SWF файлах, проигрываемых во Flash Player версии 7 или выше, host должен находиться точно в том же домене (смотри "О Flash Player и безопасности " в Использовании ActionScript). Например, SWF файл в домене www.someDomain.com, опубликованный для Flash Player 5, но проигрываемый во Flash Player 7 или выше, могут получать данные из SWF файлов, также находящихся в домене www.someDomain.com. Если вы хотите загружать данные из другого домена, вам необходимо положить файл с кросс-доменными политиками (cross-domain policy file) на сервер, на котором находится SWF файл, к которому нужно получить доступ. Для более подробной информации смотри раздел "О кросс-доменной загрузке данных " в Использовании ActionScript.

При вызове load() свойство loaded объекта XML устанавливается равным false. Когда XML данные полностью загружаются, свойство loaded делается равным true и вызывается обработчик события onLoad . XML не анализируются до полной загрузки документа. Если объект XML перед загрузкой содеражал XML деревья, они уничтожаются.

Если XMLSocket.connect() возвращает true, начальная стадия соединения прошла успешно; позднее вызывается метод XMLSocket.onConnect, чтобы определить, установлено ли соединение окончательно. Если же XMLSocket.connect() возвращает false, соединение установить не удалось.

Пример

Код в примере ниже использует метод XMLSocket.connect() для соединения с хостом, в котором находится SWF файл и использует функцию trace для отображения результата соединения:

var socket:XMLSocket = new XMLSocket()
socket.onConnect = function (success:Boolean) {
  if (success) {
    trace ("Соединение установлено!")
  } else {
    trace ("Соединение не установлено!")
  }
}
if (!socket.connect(null, 2000)) {
  trace ("Соединение не установлено!")
}

См. также

function, XMLSocket.onConnect

Посмотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление